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INTROOUCTAON TO SYSTEM/IS- MAINT 


SYSTEM/IS.MAINT is a normatoestate utility program that perforas 
Lidrary maintenance functions for tndex sequentiat files. : 


Index sequentiat files consist of one cluster file» one direct 
file» and any number of index files. | : 


The cluster file has the same name as the index sequential file 
and contains a dictionary» tisting the names of ait associated 
subfiles Cdirect and index files). 


RELATED DOCUMENTATION 


For further informations refer to the following documents. 
MCPTI Product Specification 2212 5462 
COBGL74& Corporate Standard 1283 0022 


SVSTEM/COPY Product Specification 2222 2905 
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OPERATING PROCEDURES 


EXECUTION | 


This program can be executed in one of three ways: 
- via operator display terminat (O00T) 
- via card reader 
- via psuedo~deck. 


A sample of an execute from the O0T is shown in Figure 2.1. To 
execute from the ODT» the following statement is entered. 


EX SYSTEM/IS.MAINT 


Program commands can be entered via the OOT or via a data file. 
If program input is via the ODT» the prograa goes to 


.  beginning-of-job (80J) and responds with accept messages 


requesting program input. 
If progras input is via a data files a file equation aust be 
entered at the time of the execute as shown in the following 
exauples: 

EX SYSTEM/IS.MAINTSFI SOURCE NAME CARD-FILE CARDS 


EX SYSTEM/IS.MAINT#FI SGURCE NAME IS/INPUT DISK 


INPUT VIA ODT 


The name of the cluster file upon which maintenance is to be 
perforsrned» is entered in response to the command prompt ENTER. 


FILE NAME. If the file cannot be found or is invatids ithe 


prograa informs the operator and repeats the accept operation. 


if the file is found and is a valid cluster file» the program's 
response is the display of the message ENTER COMMAND and the 
performance of another accept operation. All commands’ entered 


from this point are performed on the previously specified cluster 
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INPUT VIA DATA FILE / 
Input from a data file requires that the internal file SOURCE .’ be 
file~equated to the desired input file» at execution time. ~ The 
fide is opened using input blocking»s and each record in the file 
corresponds to a single accept message from the ODOT. Command 


prompts that normally appear are not displayed. 
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INPUT ----- 


INPUT oceee EX SYSTEM/IS.MAINT; | ? 
NUTPUT > SYSTEM/IS.MAINT =38 BOS. PP=45 MP=4 TIME = 10:30:37.7 
OUTPUT 2 2 SYSTEM/IS.SMAINT =38 ENTER FILE NAME 

QUTPUT > SYSTEM/IS.MAINT =38 ACCEPT. 

INPUT serene S8AXCL/FILE 

OUTPUT 2 SYSTEM/IS.MAINT =38 ENTER COMMAND 

OUTPUT > SYSTEM/IS.MAINT =38 ACCEPT. 


INPUT -==---38AXLIST SPO 


OUTPUT. = % SYSTEM/IS.MAINT =38 FILF NAME” 2: CL/FILE 
OUTPUT 2 Z SYSTEM/IS.MAINT =58 FILE TYPE =: INDEX SEQUENTIAL 
CUTPUT 2% SYSTEM/IS.MAINT =38 # SUBFILES =: 2 
OUTPUT 2 2 SYSTEM/IS.MAINT =38 1 4 
OUTPUT 2: % SYSTEM/IS.MAINT =38 KEYS1 O6/0A/79 
OUTPUT 2% SYSTEM/IS.MAINT =38 CL/DATA a. 8 06/08/79 
OUTPUT > % SYSTEM/IS.MAINT =38 ENTER COMMAND 

> SYSTEM/IS.MAINT =358 ACCEPT. 

----=-38AXCHANGE KEY/1 CL/KEY1 
NUTPUT > "KEY/1" CHANGED TO "CL/KEY1° 
OUTPUT 2 2 SYSTEM/IS.MAINT =38 1 STRUCTURE CHANGED 
ouTPUT > 2 SYSTEM/iS.MAINT =38 ENTER COMMANDO 
OQUTFUT 2 SYSTEM/IS.MAINT =38 ACCEPT. 
INPUT <---- ZBAXNEXT 
OUTPUT =: % SYSTEM/IS.MAINT =39 ENTER FILE NAME 
OUTPUT > SYSTEM/IS.MAINT =38 ACCEPT. 
INPUT -7---38AXEMPLUYCE/INEO 
OUTPUT 2% SYSTEM/IS.MAINY =38 ENTER COMMAND 
oOUTPUS s SYSTEM/IS.MAINI =38 ACCEPT. 
INPUT ---e- SBAXVERIF Y | | 
QUTPUT 3: SYSTEM/IS.MAINT =58 "LINE® = "BACKUP.PRI/19" 
OUTPUT > SYSTEM/IS.M4AINT =58 "BACKUPS PRT/19" RELEASED 
QUTPUT 2 2 SYSTEM/IS.MAINT =38 VERIFICATION COMPLETE - 3 FRRORS 
OUTPUT 2: 2% SYSTEM/IS.MAINT =3@ ENTER COMMAND . 
OUTPUT 3 SYSTEM/IS. MAINT =38 ACCEPT. 
INPUT =---=38RAX. 
OUTPUT > SYSTEM/IS. MAINT =38 FOJ. TIME = 10:32:53.9 


Figure 2e1 Sampie Program Execution 
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COMMAND SUMMARY 


CORMAND ENTRY 


Commands are entered via the ODT tn response to the prompts»e or 
via a data file. 
COMMAND SYNTAX OVERVIEW 
I-->CHANGE=-"><file name>---7-"--- <ftile nawes sss ss4="-="=-> ># 
i : I--TO-- 1 | { 
i | a : i; 
(32=2s CURT sss" c>> FRLADE Nake eet t 40s teeter Stes ers tee SS i 
r| _ f-eTo==1 | { 
\ 7 | 7 | ] 
Pret DEND aces ee ee ens neseea= Pom eewn a iaiaatetanetetatataatatetaete netted ‘ 
i I-->EOJ { ( 


1b tew><nell entry>-7" 


pr wm"-— HELP octet eee se ee ee ewe eet ee ee ee emma mam ew aw asa aw as enane | 


od b> TEACH 
4 


Pm mL IS Tener ee nnn ee nnn nn tn nn na nnn ne re nnn cn en nnnn=>| 


I prm-SPOtt tem H= I 
4 


I-->PRINTER@--—1 
! | | 
[== INE Tao as sn eSers Senea eS Seca st ostem anes ee eees tease ese> 
f 7 ss | 
I-->REMOVE----- a a Seas ee ne eat tee aes 
bo | | | t 
(Pee >UPDATEs"-"><file name> ---99"9-- ><file namerrerers---A- I 
4 | i i | | 
t _ * I-->TO--1 


OT ee nee 


wm Dap mme eee eeanw Se Be Beoeee wwe ee & ws w= { 
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COMMAND CROSS-REFERENCE TABLE 


COMMAND FUNCTION | : PAGE REFERENCE 
CHANGE © | Changes name of file $75 


in disk directory; 
modifies data iin 
cluster file to 
reflect new name 


Cory Copies files to tape 573 
END Terminates program 374 
—EQJ Terminates program 374 
HELP Cisplays operating | 374 


instructions 


LIST | | Produces list of names 374 
| ; and version dates for 
ati filess output can 
be sent to printer or 


~—6CODT 
| WEXT alts up new cluster | 375 
| | file 
: <nuta entry> Terminates program 374 
REMOVE Kemoves cluster file 3-5 


TEACH | Displays operating 3=5 
| instructions 


UPDATE Modifies cluster file 3-6 
ee dictionary | 
VERIFY Determines if subdfiles 3-6 
, 3 | are present in disk 7 
dictionary; produces 


hardcopy listing of. 
results 7 
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COMMAND LISTING 


CHANGE © 


Syntaxs 


wereree> CHANGE --"-"> <file name> ~------- <file name> ----> 


The CHANGE command changes the name of the file in the disk 


directory» and modifies the data in the cluster file to reflect 


the new name. In ail cases» the names of files that are part of 


an index sequential files should be changed by this command as 
opposed to using the simitar Master Control Program (MCP) 
construct. | : 


The names used within this instruction may take the form of 


either: 


<packwtid>/<multifiletid>/<fiteid> 
OR 
<packwid>/<multtfile-id>/=. 


Both names must have the same pack"tde The first name used must. 
be on disk and in the cluster file dictionary» whereas the second 


‘nage must be neither on disk nor in the cluster file dictionary. 


COPY 


Syntax: 


wene--- CUPY @=Gene sr ==="=>. <tape- naae>. Hoe eo 2 sseSeree eae rs5 


| i 
i-> TO i 


The COPY option generates a COPY message for the MCP which causes 


the cluster file and atl associated subfiles to be copied to tape 


via the SYSTEM/COPY program. SYSTEM/IS.-MAINT resumes execution 


when SYSTEM/COPY has gone to endmof-job CEDJ). If any subfiles 
are missing» the command is not processed. | 
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index sequential files can be reloaded with the ACP instruction: 
COPY =/= FROM <tape name>. 


Subfiles can also be distributed to different packs as they are 
loadeds via the syntax provided in SYSTEM/CUPY. To accoaptlish 
thise the user must know the names of all the files involved and 
their associated keys-e- It is atso necessary» thens to modify the 
cluster fite to reflect the names of the packs that now contain 
each of the files (see UPDATE option). | 


END» EQJ» OR <null> 


Either of the commands END or EQJ» or the entering of a null 
message» terminates the program. 


HELP 


The program displays its operating instructions via the ODT in 
response to this command. The TEACH command functions in_ the 
same capacity. 


fo-=> SPU w----- i 
4 j 
I*--> PRINTER ~~] 


The LiST command instructs the program to produce a listing of 
the names and version dates of the cluster file» direct files» and 
alt index fites. If SPO is specified as the List destinatton»s 
the listing is displayed on the ODT. If PRINTER is specified» a 
hardcopy listing is produced. If no destination is specifieds 
the default destination is the printer. 
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NEXT 


The NEXT command provides the capability to reference another 
cluster file. The program repeats the process of displaying the 
prompt “ENTER FILE NAME™ and performing the accept operation. 
After the new cluster file name is specified» command entry 
proceedse 


REMOVE 


This command removes the cluster file and atl of its associated 
suofiles» the names of which are cortained in the cluster file. 
For a fite to be removeds it must have the correct version date 
and no userse 


If a subfile is missing» the program disptays the fotlowing 
messagee 


NOT ALL STRUCTURES ARE PRESENT | 
DO YOU WANT THE REMUVE TO CONTINUE? - YES OR NO 


If the user enters a NO response» the program asks for another 
CORMaNG. If the response is YESs the program removes the files 
that are present. | 


After corgpteting the remove operations the program repeats the 
process of displaying an “ENTER FILE NAME” prompt» and performing 
the associated accept operation. 


TEACH 


In response to this ccmmand» the program displays its operating 
Instructtons via the ODT. This command functions in the same 
capacity as the HELP command. | 


Behe uri Le enn smatieg aint: 


te 


3-6 


BURROUGHS CORPORATION | COMPANY CONFIDENTIAL 


SMALL SYSTEMS GRUUF B1800/61700 SYSTEM/IS.~MAINT 
SANTA BARBARA PLANT PeSe 2222 3028 CA) 
UPDATE 
syntax: 
=ese2> (UPDALE “-=o2> > <file name> --7-%°> “= <file name> “-“-> 
| 1 i 
in-> 10 -!1 


The UPDATE command allows the user to sodify data in the cluster 


file dictionary to reflect the new names of direct or index 


filese The names may take the form of either: 
<pack-id>/<multifile-id>/<file-id> 
<pack~-ia>/<aultifilerid>/= 
<pack-id>/=/= | | 


if the first name used cannot be found in the cluster file» or if 
the second name is already present in the cluster file» an error 


message ts displayed. The program makes no effort to determine 
if these files are actuatly on disk. 


VERIFY 


With the VERIFY command» the program determines if all the 
subfiles are present in the disk directory» and if their version 
dates are correct. A hardcopy summary of the verification 
results is listed on the printer and the results are also 
displayed on the OUT. | 
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ERROR MESSAGES. 


érror messages are displayed on the GOT.j Error messages for this 
program are one of two types indicated by the precedence of the 
word ERROR or WARNING. 


Those error messages preceded by the word ERROR are displayed 
when the command 1s entered incorrectty and consequently cannot 
be processede- Messages tn this category» and their descriptions» 
are listed in alphabetical order. 


“ERROR - BOTH NAMES ARE THE SAME® | 
The file names used in the UPDATE or CHANGE commands cannot 
be the same. 


“ERROR - CLUSTER FILE IN USE BY ANOTHER PROGRAM* 
No other users can be accessing the cluster file white 
SYSTEM/IS MAINT. is accessing ite | 


"ERROR - CLUSTER FILE IS CORRUPTED" 
The ctuster file dictionary of subfites coutd not be read. 


"ERROR ~ CLUSTER FILE NOT FOUND® 

In response to the ENTER FILE NAME prompt» a cluster  fite 
was specified that coutd not be found. Ensure that file 1s 
on the systeme 


"ERROR - COMMAND NOT ALLOWED IN THIS CONTEXT® 
The program expected the entry of a file name. Commands 
acting ona file are not atlowed. 


“ERROR - COMMAND REQUIRES PARAMETERS” 
The entered command required parameters that were omitted. 
Refer to command syntaxe 


“ERROR - DIFFERENT PACK-IDS NOT ALLOWED IN CHANGE® 
The packtids used in the CHANGE command must be the same. 
Refer to command syntax. : 


“ERROR - iD EXCEEDS 10 CHARACTERS" | : 

The pack~id» aultifiletid»s or file~id name cannot contain 

more than 10 characters each. Refer to 381800/81700 fite 
naming conventions. | 


~fERROR = INVALID COMMAND» TRY “TEACH™ FOR LIST OF VALID 
COMMANDS" 

Either the command was erroneously entered or the command is 
not recognized by this programe 6y entering a TEACH or HELP 
commands a Listing of valid commands can be consulted. 
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"ERROR ~- MCP DENIED COPY REQUEST® 

The MCP failed to process this command» possibly because of 
invalid file or tape names. Refer to SYSTEM/COPY program 
for further explanation. . 


“ERROR - MISSING ENDING QUOTE 
The file name requiring cuoted text tacks the final 
quotation character. _ 


PERROR - MORE PARAMETERS EXPECTED? 


The program expected more parameters that were omitted. 
Refer to coamand syntax or operating instructions. 


"ERROR - NAME CONTAINS ILLEGAL DELIMNITER* 
Special characters within a file name such as “s™" require 


enclosure quotation marks. Ensure that file name conforms 
to 61800/81700 file naming conventions. 


“ERROR - NAMES HAVE UNMATCHED EQUALS” — | 
The UPDATE or CHANGE commands have been used improperty and 


tne file names have mismatched equals (=). See command 
semantics. | | 


“ERROR - NOT AN INDEX SEQUENTIAL FILE? 


“ERROR - ONLY "SPO" OR "PREINTER™ ALLOWED AFTER “LIST** 
The act or printer are the onty allowed output destinations. 
Refer to command syntax. | 


“ERROR - GNLY THREE IDS ALLOWED IN NAME* | 
The file name can contain only the pack~id> mudtifilecid» 


and file"id-e Refer to 81800/81700 file naming conventions. 


“ERROR - STRUCTURE IS NOT PART OF THIS FILE™ 


“ERROR - UNEXPECTED TEXT FOLLOWING <COMMAND or NANE>* 
More than one command was encountered. Only one command is 
ailowed per accept operation. 


“ERROR - "/" IS INCORRECTLY USED* 
File names such as “/A/B" or “A//B8"» for example» are not 
alfawed.~ Ensure that use of evan cOnoens with file raming 


conventions. 


"ERROR - "=" NOT ALLOWED AS <PACK-ID» MULTIFILE-1D- or 


FILE-10>° | 

In some casess the special character “=" is not allowed as a 
replacement for the packrids multifiletid» and/or filerid. 
Refer to command syntax. 7 
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Error messages preceded by the word WARNING are displayed when a 
command being processed encounters probleas with part of the 
task. The commands REMOVE» CHANGE» and UPDATE are subject to. 
this type of error message because they may require action on 
more than one file. These error messages have the _  fotlowing 


formate 


WARNING -<file name 1> NOT < REMOVED» CHANGEDs or UPDATED > 
C 10 <file name 2>1 - <explanation> 


The accoapanying explanations may be any of the foitlowing: 


MCP OENIED REQUEST 
NOT ON DISK | 

PACK NOT ON-LINE 
ALREADY IN DICTIONARY 
ALREADY ON DISK 
VERSION MISMATCH 

HAS USERS 
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INTERNAL FILES 


Internat File Name | Function 


IS_FILE — The cluster file that is currently 
| —— : . being accessed. 


COPY | Used to pass copy requests to the 
| SYSTEM/COPY program. | 
SGURCE If filemequated to a name other than 


ISeMAINT/SIS<MAINT/SIS«2MAINT? this file 


1s used for input commands instead of 
the ODT. 


LINE | Used for printer output. 


IxX-l 


—_ BURRUUGHS CORPORATION | a COMPANY CONFIDENTIAL 
= SMALL SYSTEMS GROUP 61800781700 SYSTEM/IS-MAINT 
SANTA BAREARA PLANT | P.S. 2222 3028 CA) 

INDEX 


CHANGE COMMAND 3-3 
CLUSTER FILES 1-1 
COMMAND CROSS“REFERENCE TABLE 3-2 
CGOMMANC ENTRY 3-1 
COMMAND LISTING 3-3 
COMMAND SUMMARY 3-1 
CUNMAND SYNTAX OVERVIEW 3-1 
CUPY CO*MAND 373 
CUPY FILE Bri 


END COMMAND 374 
EOGJ COMMAND 5” 
ERROR M*tSSAGES A-1 
EXECUTIUN 271 


FILE-EQUATING 2-1 
HELP COMMAND 374 


INDEX FILES 1-1 

INDEX SEQUENTIAL FILES 171 
INPUT VIA DATA FILE 2-2 
INPUT VIA ODT 2-1 
| os INTERNAL FILES = 8-1 | 
| | | INTRCCUCTION TO PROGRAM 1-1 
| + IS FILE 8-1 


: 2. LINE FILE B<1 
| -.° |; LIST COMMAND 3-4 
LISTINGS 374 


NEXT COMMAND 37-5 
NULL ENTRY 374 


OPERATING PROCECURES 2-1 
RELATED DOCUMENTATIUN 1-1 i 
 RELGADING INDEX SEQUENTIAL FILES 374 
REMUVE COMMAND 3°75 
SAMPLE PROGRAM EXECUTION 2-3 
SUURCE FILE 8-1 
TEACH COMMAND 3>5 
| € UPDATE COMMAND 376 


VERIFY COMMAND 3-6 


